package com.stellar.circle.basic.service;

import com.stellar.circle.basic.entity.SChatMessage;
import com.stellar.circle.controller.admin.sChatMessage.vo.SChatMessageResponseVO;

import java.util.List;

/**
 * 私聊消息表(SChatMessage)服务接口
 *
 * @author Jqchan
 * @since 2025-06-12 21:21:20
 */
public interface SChatMessageService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    SChatMessage queryById(Long id);

    /**
     * 条件查询单条结果
     *
     * @param condition 查询条件
     * @return 实例对象
     */
    SChatMessage queryByCondition(SChatMessage condition);

    /**
     * 条件查询全部结果
     *
     * @param condition 查询条件
     * @return 实例对象列表
     */
    List<SChatMessage> queryAllByCondition(SChatMessage condition);

    /**
     * 分页查询
     *
     * @param condition 查询条件
     * @param page      页码
     * @param pageSize  每页数量
     * @return 分页结果
     */
    List<SChatMessage> page(SChatMessage condition, int page, int pageSize);

    /**
     * 新增数据
     *
     * @param entity 实例对象
     * @return 影响行数
     */
    SChatMessage insert(SChatMessage entity);

    /**
     * 修改数据
     *
     * @param entity 实例对象
     * @return 影响行数
     */
    int update(SChatMessage entity);

    /**
     * 通过主键删除
     *
     * @param id 主键ID
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 条件统计
     *
     * @param condition 统计条件
     * @return 总数
     */
    Long count(SChatMessage condition);

    /**
     * 标记为已读
     *
     * @param messageId
     */
    void markAsRead(List<Long> messageId);

    /**
     * 获取历史记录
     *
     * @param conversationId
     * @param lastMsgId
     * @param limit
     * @return
     */
    List<SChatMessage> selectHistory(String conversationId, Long lastMsgId, int limit);

    /**
     * 获取未读消息
     *
     * @param userId
     * @return
     */
    List<SChatMessage> selectUnreadByUserId(Long userId);

    /**
     * 获取消息列表
     *
     * @param userId
     * @param page
     * @param pageSize
     * @return
     */
    List<SChatMessageResponseVO> getMessageList(Long userId, int page, int pageSize);

    /**
     * 获取消息列表总数
     *
     * @param userId
     * @return
     */
    Long countChatList(Long userId);
}
